home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / lib / tex / inputs / pslatex / README < prev    next >
Text File  |  1991-05-20  |  8KB  |  182 lines
  1. The files in this directory constitute the distribution of PSLaTeX, a
  2. set of extensions and changes to LaTeX to make it PostScript-based.
  3.  
  4. Before beginning, you need to obtain a set of TFM files for the fonts
  5. resident in the PostScript device you intend to use.  (The default
  6. configuration assumes you have the "standard" 13 fonts, namely the
  7. Times, Courier, Helvetica and Symbol families.)  A set of these files
  8. is distributed as part of the standard UNIX TeX distribution.
  9. Additionally, they can be found on the Aston TeX archive server in the
  10. UK, and on june.cs.washington.edu in the US.  You will probably need
  11. to do a little work on these fonts before they can be used with
  12. PSLaTeX; see the section below.  If you were using an old version of
  13. PSLaTeX, then the fonts that you used with that will be fine.  As a
  14. last resort, a set of ready-to-use fonts can be obtained from the
  15. author at the address below.
  16.  
  17. Short instructions
  18. ~~~~~~~~~~~~~~~~~~
  19. Once you have got the fonts, and unpacked PSLaTeX (by executing the
  20. shar file), you should convert the .pl files distributed with PSLaTeX
  21. to .tfm files (using pltotf, part of the standard TeX distribution),
  22. and place them into your standard TFM directory (usually
  23. /usr/lib/tex/fonts).  Then build PSLaTeX.  Instructions can be found
  24. in pslatex.tex; a short form (for UNIX sites) is given below.  LaTeX
  25. and print pslatex.tex, then, after installing PSLaTeX, process
  26. pslatex.tex with PSLaTeX.
  27.  
  28. To print DVI files produced by PSLaTeX you must have a DVI to
  29. PostScript processor capable of using unmapped device-resident fonts.
  30. Additionally, you must modify the header file downloaded to your
  31. PostScript device as per the instructions below.  (If you don't have a
  32. DVI->PostScript program, you can get one (for BSD UNIX) from the
  33. address below.)
  34.  
  35. ------------------------------------------------------------------------
  36. Summary of files
  37.  
  38. README         this file
  39.  
  40. lfonts.tex    } PSLaTeX itself
  41. pslplain.tex    }
  42. fntchoice-t.tex } rename to fntchoice.tex, if not using the Makefile.
  43.  
  44. fntchoice-[bhnp].tex
  45.         Alternative versions of fntchoice for Bookman,
  46.         Helvetica, NewCentury-Schoolbook and Palatino.
  47.         All require a LaserWriter Plus, except Helvetica.
  48.  
  49.  
  50. pslatex.tex     documentation for PSLaTeX
  51.  
  52. *.pl        PL files for "derived" PostScript fonts
  53.  
  54. makefonts.ps    PostScript code to create derived fonts
  55.  
  56. font-table    establishes the correspondence between TFM files and
  57.         PostScript fonts
  58.  
  59. Other files
  60.  
  61. BUGS
  62. Makefile
  63. fonts.tex     contains some information about the choice of fonts used by
  64.         PSLaTeX. 
  65.  
  66. Utilities to help with installation at UNIX sites:
  67. cnvfonts    converts font metric files from 1pt design size to 10pt.
  68. long2sh        create short-name links to long-name TFM files.
  69. ------------------------------------------------------------------------
  70.  
  71.  
  72.  
  73. Mario Wolczko
  74.  
  75.    ______      Dept. of Computer Science    Internet:   mario%ux.cs.man.ac.uk
  76.  /~      ~\    The University               USENET: mcvax!ukc!man.cs.ux!mario
  77. (    __    )   Manchester M13 9PL           JANET:      mario@uk.ac.man.cs.ux
  78.  `-':  :`-'    U.K.                         Tel:    +44-61-275 2000 extn 6146
  79. ____;  ;_____________the mushroom project____________________________________
  80.  
  81. The programs used to create the TFM files can also be obtained from
  82. the above address.
  83.  
  84. Trademarks, etc, can be found in pslatex.tex.
  85.  
  86.  
  87. ------------------------------------------------------------------------
  88.     Installing PSLaTeX under UNIX (assuming you are running the
  89.         standard (UofW) distribution)
  90.  
  91. 1. If you have not already done so, unpack PSLaTeX by running /bin/sh
  92.    on the shar file.  Convert each .pl file, into a .tfm file by typing
  93.     make tfms
  94.    Put the .tfm files in your standard tfm directory (usually
  95.    /usr/lib/tex/fonts; if so
  96.        make install-tfms
  97.    will do the job.)
  98.  
  99. 2. Get hold of the TFMs for the fonts resident in your PostScript
  100.    device.  For the default setup, you will need at least the following:
  101.        Times-Roman, Times-Italic, Times-Bold, Times-Oblique,
  102.        Symbol and Symbol-Oblique.
  103.    Check the design size of these fonts (convert one TFM file to PL
  104.    format using tftopl, and look for the line containing the word
  105.    DESIGNSIZE).  They should be at size 10pt, ie the line should read
  106.     (DESIGNSIZE R 10.0)
  107.    If they are at 1.0pt, you need to convert them to 10pt.  A shell
  108.    script (cnvfonts) is provided that will do this for you.
  109.  
  110. 3. Modify fntchoice.tex for the names of the TFM files to use for \rm,
  111.    etc.  (If you accept the setup as distributed, you don't need to
  112.    make any modifications.)  You may have to do this for one of two
  113.    reasons: 
  114.     a) if you have a version of dvi2ps that relies on specific types
  115.        of names for PostScript fonts, e.g., that they begin with "PS".
  116.        If this is so, you will also have to rename the TFM files
  117.        accordingly. 
  118.     b) The TFM files you use have names of the long form (eg
  119.        Times-Roman), and you don't want to change them.  As
  120.        distributed, PSLaTeX assumes you will use short names (eg
  121.        t-rom), as these are more portable amongst different operating
  122.        systems.   The correspondence between short and long names can
  123.        be found in the file font-table.
  124.    If you don't modify fntchoice.tex but have TFM files with long
  125.    names (eg Times-Roman.tfm), then you'll have to make equivalent TFM
  126.    files with short names, by copying or linking.  The shell script
  127.    long2sh will create links based on the names in font-table.
  128.  
  129. 4. Build the pslplain.fmt file:
  130.     $ initex
  131.     This is TeX, Version 2.0 for Berkeley UNIX (INITEX)
  132.     **pslplain \dump
  133.     (pslplain.tex
  134.     ...
  135.     \font\tencirc=circle10
  136.     \font\tencircw=circlew10
  137.     36832 words of font info for 108 preloaded fonts
  138.     14 hyphenation exceptions
  139.     Hyphenation trie of length 5942 has 181 ops
  140.     No pages of output.
  141.    This will use the files lplain.tex, hyphen.tex and latex.tex that
  142.    came with your standard LaTeX, but will substitute a new version of
  143.    lfonts.tex.
  144.  
  145. 5. Copy pslplain.fmt to your "standard" area for format files
  146.    (/usr/lib/tex/macros, more often than not).
  147.  
  148. 6. If you want, you can build a "preloaded" PSLaTeX (see instructions
  149.    that accompanied your TeX distribution).
  150.  
  151. ------------------------------------------------------------------------
  152.     Hints on DVI->PostScript convertors
  153.  
  154. There are many, many DVI to PostScript convertors available now, each
  155. with a different set of features.  To guide you in choosing one to use
  156. with PSLaTeX, you should bear the following in mind:
  157.  - LaTeX uses the Computer Modern (CM) fonts, for which PK, GF, or PXL
  158.    files are provided as part of the TeX distribution.  The files
  159.    contain the bitmaps used to print each glyph in a font.  PSLaTeX
  160.    uses fonts resident within the PostScript printing engine, and does
  161.    not need bitmaps for these fonts, only width information in the
  162.    form of a TeX Metric File (TFM).  Indeed, bitmaps for these fonts
  163.    are not generally available.
  164.    Therefore, a convertor to be used with PSLaTeX must recognise that
  165.    some fonts are resident within the printing engine, and not attempt
  166.    to download bitmaps.
  167.  - As mentioned in the document that describes font usage in PSLaTeX,
  168.    some of the fonts used are derived (by simple geometric
  169.    transformations, implemented in PostScript) from the existing
  170.    fonts.  Oblique fonts are made by "sloping" an upright font,
  171.    SmallCaps fonts contain the upper-case glyphs from an existing font
  172.    reduced by 20%, etc.  It would be nice if such fonts had been
  173.    designed from scratch and made available to the general public, but
  174.    they haven't been, and we're stuck with the situation.  Hence some
  175.    PostScript needs to be sent to the printer to "generate" these
  176.    fonts.  Suitable PostScript can be found in makefonts.ps, and this
  177.    can be tacked onto the end of any existing header file that your
  178.    convertor uses.
  179. ------------------------------------------------------------------------
  180. More information, and a guide to possible problems, is in pslatex.tex.
  181. ------------------------------------------------------------------------
  182.